Skip to content

docs: Add dedicated page for multi agent docs#11279

Merged
sjrl merged 12 commits into
mainfrom
multi-agent-docs
May 11, 2026
Merged

docs: Add dedicated page for multi agent docs#11279
sjrl merged 12 commits into
mainfrom
multi-agent-docs

Conversation

@sjrl
Copy link
Copy Markdown
Contributor

@sjrl sjrl commented May 8, 2026

Related Issues

Proposed Changes:

Add a dedicated Multi-Agent Systems docs page to better highlight how Haystack supports multi agent architectures and provide some guidance on how to set it up.

How did you test it?

Ran the code blocks locally to make sure they work.

Notes for the reviewer

Checklist

  • I have read the contributors guidelines and the code of conduct.
  • I have updated the related issue with new insights and changes.
  • I have added unit tests and updated the docstrings.
  • I've used one of the conventional commit types for my PR title: fix:, feat:, build:, chore:, ci:, docs:, style:, refactor:, perf:, test: and added ! in case the PR includes breaking changes.
  • I have documented my code.
  • I have added a release note file, following the contributors guidelines.
  • I have run pre-commit hooks and fixed any issue.

@vercel
Copy link
Copy Markdown

vercel Bot commented May 8, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
haystack-docs Ready Ready Preview, Comment May 11, 2026 8:27am

Request Review

@sjrl sjrl self-assigned this May 8, 2026
@sjrl sjrl marked this pull request as ready for review May 11, 2026 07:31
@sjrl sjrl requested a review from a team as a code owner May 11, 2026 07:31
@sjrl sjrl requested review from julian-risch and removed request for a team May 11, 2026 07:31
@claude
Copy link
Copy Markdown

claude Bot commented May 11, 2026

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

Copy link
Copy Markdown
Member

@julian-risch julian-risch left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Two small suggestions how to improve. All in all looks quite good to me already! 👍

Comment thread docs-website/docs/concepts/agents/multi-agent-systems.mdx
### `ComponentTool`

`ComponentTool` wraps an agent directly without a wrapper function.
Choose it when you want **declarative configuration**: the full specialist setup (model, tools, system prompt) lives in one serializable object alongside the coordinator.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What do you think about listing a declarative configuration example here too? A YAML file showing a Multi Agent System configured with ComponentTool? I suggest we add it but maybe you already thought about that and have a good reason against it?
I'd argue that it's particularly useful to show a YAML here because the recommended way differs for Python code (@tool decorator) and YAML (ComponentTool) here. Might be good for LLMs that look into our docs too.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

added a yaml example

sjrl and others added 2 commits May 11, 2026 10:00
…-agent-systems.mdx

Co-authored-by: Julian Risch <julian.risch@deepset.ai>
Co-authored-by: Julian Risch <julian.risch@deepset.ai>
@sjrl sjrl merged commit 7331620 into main May 11, 2026
22 checks passed
@sjrl sjrl deleted the multi-agent-docs branch May 11, 2026 08:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants